home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / protohlp.zip / SPROTO.HLP
Text File  |  1992-03-02  |  86KB  |  1,738 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.    ▄▄▄▄                                      ▄██████▄    ▄██████▄      ▄▄▄▄
  9.  ▄██▀▀▀▀█▄                                  ▐▌ ▐█▌ ▀█▌  ▐▌ ▐█▌ ▀█▌   ▄██▀▀▀▀█▄
  10.  ▀████▄▄    ▐     ▄▀████▄    ▄███▄ █▀██▄▄▄  ▐   █  ▄▀   ▐   █  ▄▀    ▀████▄▄
  11. ▄   ▀▀▀██▄  █     ▐ ██  ▀█▄ ▐█▀   █  ██▀▀▀█▄    ██▀▀▀█▄     ██▀▀▀█▄ ▄   ▀▀▀██▄
  12. ▌      ▐██ ▐█     █ ▐█   ██ ██▄▄▄    █▌    ▀▌  ▐█▌    █▌▌  ▐█▌    █▌▌      ▐██
  13. █▄    ▄██▌ ▐█▄  ▄█▌ ▐██▄█▀  ▐█▄   ▄  █▌     ▐▌ ██    ▄█▌▐▌ ██     █▌█▄    ▄██▌
  14.  ▀██████▀   ▀████▀  ██▀▀     ▀████▀ ▐██▄     ▀████████▀  ▀████████▀  ▀██████▀
  15.                     ██
  16.                     █▌             Protocol Setup for version 1.15+
  17.                     █              Written by Bob Henderson
  18.                     ▌              Fido 1:3812/10
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.     
  64.     ───────────────────────────────────────────────────────────────────────
  65.                          SuperBBS 1.15+ Protocol HELP
  66.     ───────────────────────────────────────────────────────────────────────
  67.  
  68.  
  69.  
  70.  
  71.                                    I N D E X
  72.                                    ─────────
  73.             Description....................................Page #
  74.             ─────────────────────────────────────────────────────
  75.             What to look for in a protocol.......................1
  76.             My personal setup....................................1
  77.             Environment variables................................2
  78.             What happens next?...................................3
  79.             Ramdrives............................................3
  80.             16550 uarts..........................................3
  81.             Config and Sproto.Bbs................................4
  82.             General protocol help................................5
  83.             DSZ or GSZ...........................................6
  84.             MPT/PUMA.............................................7
  85.             LYNX.................................................9
  86.             Microtech protocols.................................10
  87.             SzModem.............................................12
  88.             HS/Link.............................................12
  89.             SuperK..............................................14
  90.             BiModem.............................................16
  91.             Global downloads w/single file......................20
  92.             Errorlevel protocols................................21
  93.             Other protocols.....................................23
  94.             Modem Settings......................................23
  95.             Who is Bob?.........................................25
  96.             Credits.............................................26
  97.             Now what?...........................................26
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.     ───────────────────────────────────────────────────────────────────────
  124.     Bob Henderson (1:3812/10)                                         Index
  125.     ───────────────────────────────────────────────────────────────────────
  126.     ───────────────────────────────────────────────────────────────────────
  127.                          SuperBBS 1.15+ Protocol HELP
  128.     ───────────────────────────────────────────────────────────────────────
  129.  
  130.         Setting up  external protocols with  any BBS can  be a real  chore.
  131.     First you should  know all you can about the  protocol that you want to
  132.     use. I will stress this here. READ  THE DOCS! You must be familiar with
  133.     the  protocol and  its switches.  Some of  them use  / or  - for switch
  134.     characters, some  don't. Some want a  \ on the end  of the upload path,
  135.     some have case sensitive switches, p and P are not the same to DSZ. You
  136.     should ask  yourself a few  questions about the  external protocol that
  137.     you want to set up.
  138.  
  139.         Is it stable? i.e. No lock ups.
  140.         Does it support SHAREing of files ? ( for multi-line )
  141.         Will it support locked port rates? (Most do)
  142.         Can the transfer be aborted? (??)
  143.         Can it transfer multiple files? (Batch Transfer)
  144.  
  145.         You can probably think of a  few others. Once you find that perfect
  146.     protocol you then have to interface it  to some other program such as a
  147.     communication program  or a BBS package  (SuperBBS). The SuperBBS setup
  148.     is where  I come in.  Granted that  I  may leave something  out in this
  149.     document or  something may not  work correctly on  your system but  you
  150.     should be able to get some very helpful information from this document.
  151.     I would distribute  a SPROTO.BBS to go  along with it but  since I felt
  152.     that many  people would just copy  it over to their  SuperBBS directory
  153.     and expect  it to run  (NOT!). Instead of  doing this I  will paste the
  154.     info that you need to put in  the config.exe and you can print or write
  155.     down whatever  you want, this way  I am at least  assured that you know
  156.     you will be using a particular protocol and that the paths and switches
  157.     are correct.
  158.  
  159.         Up until the time SuperBBS  supported external protocols I had used
  160.     Filedoor v2.03 for external protocols.  Filedoor is a very nice program
  161.     but using it requires you to set up yet another external door. Filedoor
  162.     did  handle the  protocols very  well and  has a  few more  options for
  163.     calling  protocols. I  still use   it today  to test  protocols, mainly
  164.     because editing their text file configuration file is easier and can be
  165.     changed online between running tests.
  166.  
  167.     M Y   S E T U P
  168.     ───────────────
  169.  
  170.         First  a little  information about  my setup.  This might  help you
  171.     determine something, don't  know what but it always  helps to know what
  172.     the other person (me) is running.
  173.  
  174.         386/25, 64k memory cache, 8 megs RAM
  175.         Desqview 2.42, QEMM 6.02
  176.         Hyperdisk 4.31, 2megs Expanded memory cache
  177.         Nifty James Ram Disk, Enhanced version, 1.4 megs
  178.         16550 AFN National Semi-conductor UART chips, both ports
  179.         US Robotics HST/Dual Standard, COM1, locked at 38400 baud
  180.         ZOOM 2400 v.42bis, COM2, locked at 9600 baud
  181.         X00 v1.24 Fossil Driver or BNU v1.70, depends on how I feel.
  182.         SuperBBS v1.15+ with 3 nodes, one is local.
  183.         Thousands of Doors (you know what I mean?)
  184.  
  185.     ───────────────────────────────────────────────────────────────────────
  186.     Bob Henderson (1:3812/10)                                       Page  1
  187.     ───────────────────────────────────────────────────────────────────────
  188.     ───────────────────────────────────────────────────────────────────────
  189.                          SuperBBS 1.15+ Protocol HELP
  190.     ───────────────────────────────────────────────────────────────────────
  191.  
  192.         If your setup is similar to this, you should have no problems then,
  193.     if yours differs somewhere then you might need to make some adjustment.
  194.     I will try to  give you some tips on each  protocol that I have tested.
  195.     If  you run  a locked  port rate  of 19200  or higher  there are  a few
  196.     protocols that you cannot use. Most are older ones that have faded away
  197.     or are no  longer supported. Some of the protocols  will work for 19200
  198.     and  not 38400,  this goes  back to  the programmer  most likely.  They
  199.     probably used  a integer for  the baud variable  instead of a  unsigned
  200.     integer.
  201.  
  202.     E N V I R O N M E N T  V A R I A B L E S
  203.     ────────────────────────────────────────
  204.  
  205.         The  first and  most important  thing is  to set  a few environment
  206.     variables that the protocols can use.
  207.  
  208.         SET DSZLOG=<path\filename>    Name of DSZ log file
  209.         SET COM?=<locked rate>        Microtech protocols
  210.         SET SBBS=<path>               SuperBBS
  211.  
  212.         Of course there are many more  variables needed to run your BBS but
  213.     this is supposed to cover protocols and not the entire BBS operation.
  214.  
  215.     DSZLOG= This will tell DSZ along with  many other protocols to use this
  216.             setting  for their  log file.  It is  IMPORTANT in a multi-line
  217.             situation to set  this to something different for  each line. I
  218.             would recommend  setting this in  your autoexec.bat so  you can
  219.             get the environment space, then changing it in each nodes batch
  220.             file. You should also give a  complete PATH and File name, like
  221.             C:\SBBS\DSZ.LOG  The reason  for this  is if  something changes
  222.             directories you may  end up with DSZ.LOG's all  over the place.
  223.             Check the part on ramdrives, you may want to assign your DSZlog
  224.             to a ramdrive. If your running  a multi-node set up, change the
  225.             DSZlog  variable   in  each  nodes  batch   file  to  something
  226.             different. Mine runs like ..
  227.  
  228.                 Node 1 = I:\SBBS\DSZLOG.N1
  229.                 Node 2 = I:\SBBS\DSZLOG.N2 and so on.
  230.  
  231.     COM?=   All of the Microtech protocols use this variable for the locked
  232.             baud rate,  something like SET  COM1=38400. Microtech can  also
  233.             use a command line switch, but  this option is not available on
  234.             all  protocols where  as the  SET statement  applies to  ALL of
  235.             them.  In  a  multinode  setup  it  will  be  easier to use the
  236.             environment variables  than to edit each  nodes sproto when you
  237.             change the locked port rate.
  238.  
  239.     SBBS=   SuperBBS  needs this  variable, whether  running multi-line  or
  240.             not.  Sbbs changes  directories when  doing file  transfers and
  241.             this  will help  insure that  Sbbs can  find any  configuration
  242.             files that it needs. SET SBBS=C:\SBBS, would tell SuperBBS that
  243.             all of it's configuration files can  be found on C drive in the
  244.             SBBS directory.
  245.  
  246.  
  247.     ───────────────────────────────────────────────────────────────────────
  248.     Bob Henderson (1:3812/10)                                       Page  2
  249.     ───────────────────────────────────────────────────────────────────────
  250.     ───────────────────────────────────────────────────────────────────────
  251.                          SuperBBS 1.15+ Protocol HELP
  252.     ───────────────────────────────────────────────────────────────────────
  253.  
  254.     W H A T   H A P P E N S   N E X T ?
  255.     ───────────────────────────────────
  256.  
  257.         When SuperBBS executes your external  protocol it will make a files
  258.     listing for batch protocols and de-initialize the fossil driver, if the
  259.     protocol requires the fossil to be hot use a *H on the protocol command
  260.     line. On Uploads, Sbbs will change directories to your specified upload
  261.     directory  (optional data  in menu)  then execute  protocol. On  Global
  262.     downloads SuperBBS WILL NOT change directories. This is a minor problem
  263.     for  non-batch  transfers.  When  you  execute  a  protocol and pass %1
  264.     (filename) to it,  it is not expanded into the  complete path and name.
  265.     The protocol  will come back "File  not found!" This only  happens on a
  266.     global  file download  and when  the file  is somewhere  other than the
  267.     current directory.  I have worked a  small (awkward) fix for  this with
  268.     the use  of a batch  file. Granted it's  not a perfect  fix but it does
  269.     work fine. I will explain it further on down in this document.
  270.  
  271.     Q: Where should I put all these external protocols?
  272.  
  273.     A: Anywhere you want!
  274.  
  275.         The way I have it set up is to keep all protocols and external comm
  276.     programs in a  directory. Mine is named C:\EXT,  also this directory is
  277.     in the  DOS Path. What this  means is, if a  program executes something
  278.     and it is not in the current directory DOS will search the PATH for the
  279.     named program.  C:\EXT has external protocols,  transfer programs, comm
  280.     programs and similar related programs. Besides keeping these files in a
  281.     different directory it will make your  Sbbs directory look a lot better
  282.     and when  a upgrade comes  along you will  know where to  go. TIP: Keep
  283.     directory names  short, that way you  can add it to  the path statement
  284.     which has a limit of 127 characters.
  285.  
  286.     R A M D R I V E S
  287.     ─────────────────
  288.  
  289.         If you  have the memory try  installing a Ram Drive,  I would think
  290.     that 30-50 k should be enough. Then in your autoexec.bat add..
  291.         MD <drive>:\SBBS
  292.     <drive>  would  be  the  drive  assigned  to  your  ramdrive. Why use a
  293.     ramdrive ? The log files that the protocols make are deleted after Sbbs
  294.     reads them so why not tear up a ramdrive, also the file lists that Sbbs
  295.     creates are deleted after the  protocol uses them. Same philosophy. You
  296.     should assign a  directory to use. DOS places a  limitation on how many
  297.     files that the  root directory can hold, but there  is no limitation on
  298.     the amount files kept in sub-directories.
  299.  
  300.     1 6 5 5 0   U A R T S
  301.     ─────────────────────
  302.  
  303.         You have heard it a million times  "Buy a 16550 uart, it will solve
  304.     all your problems". And it will! Well most of your problems. If you are
  305.     plagued by many transfer errors at high speeds (9600+) then you need to
  306.     get one  of these chips. They  are very inexpensive and  are relatively
  307.     easy  to install.  If you  are  running  in Desqview  at any  baud rate
  308.  
  309.     ───────────────────────────────────────────────────────────────────────
  310.     Bob Henderson (1:3812/10)                                       Page  3
  311.     ───────────────────────────────────────────────────────────────────────
  312.     ───────────────────────────────────────────────────────────────────────
  313.                          SuperBBS 1.15+ Protocol HELP
  314.     ───────────────────────────────────────────────────────────────────────
  315.  
  316.     besides  2400 you  NEED one.  If you  don't have  it just about anytime
  317.     someone is  downloading they will  most likely receive  errors when you
  318.     try to  do something in another  window. DSZ and GSZ  slice out so much
  319.     time in DV  that just one little interruption can  send them into crash
  320.     recovery.
  321.  
  322.     C O N F I G   a n d   S P R O T O . B B S
  323.     ─────────────────────────────────────────
  324.  
  325.         To add your  protocols to the BBS you will  have to enter them into
  326.     the external  protocols file using  CONFIG. Crank up  CONFIG and choose
  327.     Files and  then external protocols. Familiarize  yourself with the data
  328.     that will be needed to run a external protocol.
  329.  
  330.     Activated.....: Simply yes or no. Is this  protocol going to be used in
  331.                     the protocol going to be available to the users?
  332.  
  333.     Name..........: The Name of the protocol. Not much room here but enough
  334.                     to tell the user what it is.
  335.  
  336.     Key...........: What key will activate this protocol
  337.  
  338.     Batch.........: Is this protocol capable  of transferring more than one
  339.                     file at a time?
  340.  
  341.     Protocol Type.: There  are only  2  types  really available,  OTHER and
  342.                     BIMODEM(ICOM). The unused is  hopefully to add a option
  343.                     for errorlevel protocols? How about it Aki?
  344.  
  345.     Log Style.....: What type  of log file will  this protocol create? DSZ,
  346.                     Bimodem(ICOM) or OTHER. The first two should cover most
  347.                     all protocols your need to  run. The OTHER would be for
  348.                     those  protocols  that  create  a  log  file but have a
  349.                     different  format. Using  OTHER you  will have  to give
  350.                     some other information below.
  351.  
  352.     Download Cmd..: This would  be the command to  execute the protocol and
  353.                     get it to  start sending files. This is  where you need
  354.                     to know  where the protocol  is because command.com  is
  355.                     not  loaded  and  Sbbs  will  not  search for the file.
  356.                     Something   like..   C:\EXT\GSZ.EXE   ..........   Also
  357.                     remember  that  the  command  line  is  limited  to 127
  358.                     characters unless  you are running  4DOS. This includes
  359.                     expansion, *B could be 4 or 5 characters, 2400 .. 14400
  360.                     baud. You can use any  of the parameters that you might
  361.                     use  for  a  menu  type  7  plus  some extras. %1 would
  362.                     translate to the filename, %2 = Users download limit in
  363.                     bytes, %3 = time left.
  364.  
  365.     Upload Cmd....: Same as the download command but to receive files.
  366.  
  367.     Log file name.: What is the name of the log file that the protocol will
  368.                     create? Remember  the SET DSZLOG= variable  and use the
  369.                     same name  if the protocol  makes a compatible  DSZ log
  370.                     file.
  371.     ───────────────────────────────────────────────────────────────────────
  372.     Bob Henderson (1:3812/10)                                       Page  4
  373.     ───────────────────────────────────────────────────────────────────────
  374.     ───────────────────────────────────────────────────────────────────────
  375.                          SuperBBS 1.15+ Protocol HELP
  376.     ───────────────────────────────────────────────────────────────────────
  377.  
  378.     Control file..: This  is created  when SuperBBS  executes the protocol.
  379.                     The file will  be a straight ASCII file  that will have
  380.                     the path and names of  files to download. Only used for
  381.                     batch protocols  but is created if  there is a filename
  382.                     here.  If you  are running  multinode you  will have to
  383.                     name this  file differently for  each node. Most  batch
  384.                     protocols  use this  file to  find out  which files  to
  385.                     send. Usually passed to protocol like @filelist.
  386.  
  387.     Efficiency....: How efficient is the protocol?  This is a percentage on
  388.                     how the protocol does against  the actual baud rate. If
  389.                     the protocol does 235 cps at 2400 baud then it would be
  390.                     around  98% efficient.  Sbbs  will  use this  number to
  391.                     calculate transfer times to be displayed to the user.
  392.  
  393.     Download Str..: Usually  %1 will  do here,  %1 is  translated in to the
  394.                     name of the file and is  what Sbbs will look for in the
  395.                     log  file  to  determine  if  the  file was transferred
  396.                     correctly.  You could  put E:\UPLOADS\%1  but then Sbbs
  397.                     would not acknowledge the file transfer unless it found
  398.                     exactly that path in the log file.
  399.  
  400.     Upload Str....: Same as download string but for uploads.
  401.  
  402.     DL log keyword: If you selected  OTHER for log file type  you will need
  403.                     to fill this in. What it wants is the character or word
  404.                     that will be  in the log file that  says a transfer was
  405.                     successfully done.  See example for Tmodem  for more on
  406.                     this.
  407.  
  408.     UL log keyword: Same as download keyword but for uploads.
  409.  
  410.     File Name word: Most  log files  are broken  up into  columns, like  it
  411.                     might say..
  412.                     S  12233  SOMEFILE.ZIP
  413.                     R  34000  OTHERFIL.ZIP
  414.                     What your enter  here is the column that  Sbbs can find
  415.                     the filename in. Note that  this number appears to be 0
  416.                     based. For the example 0=keyword, 1=size, 2=filename.
  417.  
  418.         Seems like a lot to enter  but depending on how many other programs
  419.     you have  set up this is  rather simple. It's just  a matter of getting
  420.     used to it.
  421.  
  422.     G E N E R A L   H E L P
  423.     ───────────────────────
  424.  
  425.         In each  of the individual help  sections I will cover  the correct
  426.     installation of  each protocol. What  I mean by  correct is, Sbbs  will
  427.     acknowledge that  a file was  sent or received.  The protocol will  not
  428.     pause  or abort.  I will  also  cover  some different  aspects of  each
  429.     protocol and  paste a picture  of the setup  for that protocol  in each
  430.     section. You can print this document and then transfer the information.
  431.     Be sure  you change any  paths that I  specify to the  correct path for
  432.  
  433.     ───────────────────────────────────────────────────────────────────────
  434.     Bob Henderson (1:3812/10)                                       Page  5
  435.     ───────────────────────────────────────────────────────────────────────
  436.     ───────────────────────────────────────────────────────────────────────
  437.                          SuperBBS 1.15+ Protocol HELP
  438.     ───────────────────────────────────────────────────────────────────────
  439.  
  440.     your setup. Basically I will hope to set you up on a protocol as easily
  441.     as  possible.  Of  course  there  is  no  guarantee  that  all of these
  442.     protocols will  work on your  system, but the  only way to  find out is
  443.     try. Please not that some of the command lines were to long and wrapped
  444.     to the next line, I will indent these so it is easier to read.
  445.  
  446.     D S Z  o r  G S Z
  447.     ─────────────────
  448.  
  449.         DSZ  is probably  one of  the most  popular external protocols that
  450.     people use. This  would make a great addition  to your system. Ymodem-G
  451.     or redirected uploads  in DSZ or GSZ will not  work in the unregistered
  452.     versions.  If you  can, you  should register  DSZ. DSZ's Ymodem-G works
  453.     very well  and the ability to  redirect and rename downloads  is a nice
  454.     feature. Besides it does work well and is constantly updated.
  455.  
  456.         DSZ will probably be the easiest  protocol you setup. For one thing
  457.     DSZ does not  rely on locked ports or  passing the baud rate to  do its
  458.     stuff. DSZ is also very reliable  and quick. Zmodem Mobyturbo being the
  459.     favorite DSZ protocol. DSZ is also  SHARE compatible and will allow two
  460.     or more users to download the same file at the same time.
  461.  
  462.         Set your DSZLOG variable as described above. It is important to use
  463.     a full path\name for your DSZ.LOG. If your using a ramdrive remember to
  464.     assign your  log to that  drive. Also remember  to use a  different log
  465.     file  for each  node when  running multinode.  I also  use the  DSZPORT
  466.     variable to tell DSZ which port to  use, SET DSZPORT=2 will tell DSZ to
  467.     use COM2 when  it executes. This way you can  have a different variable
  468.     in each window in  DV and not worry about DSZ using  the wrong port. If
  469.     you don't  want to do  this you could  specify "port 2"  on the command
  470.     line for DSZ.
  471.  
  472.         Here is an example of the config setup...
  473.     ───────────────────────────────────────────────────────────────────────
  474.     Activated           : Yes
  475.     Name                : DSZ Moby Zmodem
  476.     Key                 : M
  477.     Batch               : Yes
  478.     Protocol type       : OTHER
  479.     Log style           : DSZ
  480.     Download command    : c:\ext\gsz.exe est 0 *B pV1 sz -m @i:\files.n1
  481.     Upload command      : c:\ext\gsz.exe est 0 *B pV1 rz -m
  482.     Log file name       : i:\sbbs\dszlog.n1
  483.     Control file name   : i:\files.n1
  484.     Effic               : 98
  485.     Download Ctl Str    : %1
  486.     Upload Ctl Str      : %1
  487.     Download log keyword:
  488.     Upload log keyword  :
  489.     File name word NR.  : 0
  490.     ───────────────────────────────────────────────────────────────────────
  491.  
  492.         Most people  will probably say  "Bob, where's all  the switches for
  493.     DSZ?". Well  the best thing about  DSZ is most of  the defaults are the
  494.  
  495.     ───────────────────────────────────────────────────────────────────────
  496.     Bob Henderson (1:3812/10)                                       Page  6
  497.     ───────────────────────────────────────────────────────────────────────
  498.     ───────────────────────────────────────────────────────────────────────
  499.                          SuperBBS 1.15+ Protocol HELP
  500.     ───────────────────────────────────────────────────────────────────────
  501.  
  502.     switches that you are using. I  have seen more command lines with "CON"
  503.     or "handshake both" that don't need to be there. These are defaults for
  504.     DSZ. I  simply want DSZ to  estimate the transfer for  the correct baud
  505.     rate. If you run a locked port you  will know what I mean. DSZ uses the
  506.     locked port  rate for estimating the  time of transfer and  at 38400 it
  507.     looks kinda funny. So "est 0 *B"  will translate out when DSZ is called
  508.     and the transfer times on your end  will be correct. "pV1" tells DSZ to
  509.     do direct screen writes, although you  should not do this in Desqview I
  510.     have never  found it to bleed  through to another screen.  "sz" or "rz"
  511.     tells  DSZ  to  do  Zmodem   transfers  while  "-m"  is  for  Mobyturbo
  512.     enhancement on Zmodem. Notice that I use  a log file name with a number
  513.     in it, If  your running more than one  line then yours will have  to be
  514.     similar  to avoid  any possible  share violations.  Also I:  is my  ram
  515.     drive, why not tear it up on those small files.
  516.  
  517.         On the download  and upload control string just use  a %1 and don't
  518.     put  anything for  the download  directory on  any of  the DSZ  receive
  519.     commands. Reason? Using %1 tells Sbbs to just look for the filename, if
  520.     your  use the  command line  DSZ est  0 *B  rz -m  %1, DSZ will log the
  521.     filename and  the directory. Sounds  ok but there  is a catch.  DSZ was
  522.     written in C and in C you can use \ or / for delimiters in the path and
  523.     this is what screws up Sbbs, In pascal C:/UPLOADS/FILENAME.ZIP is not a
  524.     valid filename, then  Sbbs assumes the file was  not transferred. Trust
  525.     me! Don't give DSZ  a download path and all will be  fine. It will then
  526.     only log the filename and all will be OK!
  527.  
  528.         Other than what  I mentioned above there should  be nothing special
  529.     to  do with  DSZ, no  configs for   it. Just  place it  in a  directory
  530.     somewhere and let it run. DSZ is also very very Desqview aware, running
  531.     it in the background is a no problem, even at 14400 HST speeds it seems
  532.     like it's not there.
  533.  
  534.         To  use Ymodem  or Ymodem-g  just change  the command  line to  the
  535.     correct protocol, "rb" Ymodem receive, "sb" Ymodem send. Add a "-g" for
  536.     enabling the  error correcting portion  of Ymodem. For  Xmodem you will
  537.     have to do it a different way. Read the section on Global downloads.
  538.  
  539.     P U M A  /  M P T
  540.     ─────────────────
  541.  
  542.         MPT (used to  be Puma) is something you should  add to the protocol
  543.     list. Although it  is not supported by the author  anymore it is one of
  544.     the users favorites.  It has this amazing status  screen that gives you
  545.     total information  while the transfer  is going on.  It also is  a very
  546.     efficient protocol,  with RLE compression that  will compress files (if
  547.     it can) and  send them out that way. This  further increases the speed.
  548.  
  549.         Not to  many switches here, you  should run MPTSET and  look at the
  550.     options  and set  things like   overwrite files  and crash  recovery to
  551.     whatever suits your needs. If your  running multiline DON'T set the log
  552.     file to  anything in MPTSET,  you will be  doing this from  the command
  553.     line. MPT creates  a DSZ compatible log file so  it will using that log
  554.     file type.
  555.  
  556.  
  557.     ───────────────────────────────────────────────────────────────────────
  558.     Bob Henderson (1:3812/10)                                       Page  7
  559.     ───────────────────────────────────────────────────────────────────────
  560.     ───────────────────────────────────────────────────────────────────────
  561.                          SuperBBS 1.15+ Protocol HELP
  562.     ───────────────────────────────────────────────────────────────────────
  563.  
  564.         MPT  does support  batch file  transfers, is  SHARE aware  and even
  565.     Desqview aware in the sense it will  write to the DV video buffer. Only
  566.     one problem with that though, since  in you are running a fossil driver
  567.     and  it has  at least  int 14h  interrupt MPT  does not  think it's  in
  568.     Desqview.  It will  bleed through  to other  screens if  you don't have
  569.     "Displays  graphics" turned  on for  that window  in Desqview. There is
  570.     minimal bleed when "graphics" is  turned off and "virtualize screen" is
  571.     set  to 'T'ext.  I have  found Puma/Mpt  to be  a very  stable program,
  572.     except for the little bleeding it does in Desqview it does pretty good.
  573.     One thing to note, MPT is very fast and does support crash recovery but
  574.     is not a very good protocol for noisy telephone lines. It seems that it
  575.     is very sensitive  to that and at higher  baud rates a 16550 uart  is a
  576.     must. This what my screen looks like in MPTSET
  577.  
  578.         COM port  : 1         Beep when finished : No
  579.         UART baud : Current   Use 16550A FIFOs   : Yes
  580.         Eff. baud : UART      CTS/RTS handshake  : Fast
  581.         COM1 base : 3F8       DCD monitoring     : Yes
  582.         COM1 irq  : 4         Modem hangup       : No
  583.         COM2 base : 2F8       Wait for key       : No
  584.         COM2 irq  : 3         RLE compression    : Yes
  585.         COM3 base : 3E8       Kill aborted files : No
  586.         COM3 irq  : 4         Current date stamp : Yes
  587.         COM4 base : 2E8       Overwriting files  : No
  588.         COM4 irq  : 3         Resuming transfers : No
  589.  
  590.         CDS log file = none
  591.         DSZ log file = none
  592.  
  593.         Of course your settings may differ  from mine but this may give you
  594.     something to  start with. Pay  more attention to  the right column  and
  595.     change any settings you feel necessary.
  596.  
  597.         Here is an example of the config setup...
  598.     ───────────────────────────────────────────────────────────────────────
  599.     Activated           : Yes
  600.     Name                : Puma/Mpt v1.10
  601.     Key                 : P
  602.     Batch               : Yes
  603.     Protocol type       : OTHER
  604.     Log style           : DSZ
  605.     Download command    : c:\ext\mpt.exe P*P E*B S9600 Li:\sbbs\dszlog.n*N
  606.                           S @i:\files.n2
  607.     Upload command      : c:\ext\mpt.exe P*P E*B S9600 Li:\sbbs\dszlog.n2 R
  608.     Log file name       : i:\sbbs\dszlog.n2
  609.     Control file name   : i:\files.n2
  610.     Effic               : 98
  611.     Download Ctl Str    : %1
  612.     Upload Ctl Str      : %1
  613.     Download log keyword:
  614.     Upload log keyword  :
  615.     File name word NR.  : 0
  616.     ───────────────────────────────────────────────────────────────────────
  617.  
  618.  
  619.     ───────────────────────────────────────────────────────────────────────
  620.     Bob Henderson (1:3812/10)                                       Page  8
  621.     ───────────────────────────────────────────────────────────────────────
  622.     ───────────────────────────────────────────────────────────────────────
  623.                          SuperBBS 1.15+ Protocol HELP
  624.     ───────────────────────────────────────────────────────────────────────
  625.  
  626.         MPT  will require  the port  to  use  on the  command line,  use *P
  627.     instead of putting  the number there. Makes things  a lot easier later.
  628.     MPT also will use the locked port rate to estimate file transfers. With
  629.     all the  information that MPT  displays on the  screen it doesn't  look
  630.     right when a  2400 baud caller can download a  100k file in 24 seconds.
  631.     Use the E*B to  tell MPT to use *B true baud  rate to estimate time. Ok
  632.     here comes the  log file. In MPTSET you  can set the log file  but when
  633.     running multiline you  will need to set it  here. L<log file>, remember
  634.     the DSZ variable. You  will have to enter the path and  name of log and
  635.     make sure it  matches the log file name listed  under "Log file name" I
  636.     also used the  *N here for node number. Sbbs  will expand all variables
  637.     on the command line, only problem is it will not expand them on the log
  638.     file  name and  control file  name.  98%  efficiency for  this one  (or
  639.     better).
  640.  
  641.     L Y N X
  642.     ───────
  643.  
  644.         Lynx is  one of those protocols  that just works good.  It also has
  645.     RLE  compression to  speed up  transfers. Nothing  particular to  worry
  646.     about  here.  It  makes  a  DSZ  compatible  log  file using the DSZLOG
  647.     variable  for the  filename. The  only strange  thing about  Lynx is it
  648.     needs to know  the locked port rate. It  will not work if you  pass the
  649.     true baud rate and have the port locked at 9600-38400. Granted the file
  650.     estimate time will be off at least the protocol will work.
  651.  
  652.         Here is an example of the config setup...
  653.     ───────────────────────────────────────────────────────────────────────
  654.     Activated           : Yes
  655.     Name                : Lynx v3.02
  656.     Key                 : L
  657.     Batch               : Yes
  658.     Protocol type       : OTHER
  659.     Log style           : DSZ
  660.     Download command    : c:\ext\lynx.exe S /*P /9600 /H @i:\files.n2
  661.     Upload command      : c:\ext\lynx.exe R /*P /9600 /H
  662.     Log file name       : i:\sbbs\dszlog.n2
  663.     Control file name   : i:\files.n2
  664.     Effic               : 98
  665.     Download Ctl Str    : %1
  666.     Upload Ctl Str      : %1
  667.     Download log keyword:
  668.     Upload log keyword  :
  669.     File name word NR.  : 0
  670.     ───────────────────────────────────────────────────────────────────────
  671.  
  672.         Lynx requires  you to tell it  which port it is  on, this should be
  673.     the first parameter AFTER telling it which way to do transfer (S or R).
  674.     Just put  /*P and that should  cover it. Next for  locked port settings
  675.     put /<locked  rate> If you  are not running  a locked port  use /*B The
  676.     next  parameter is  only for   error correcting  modems, /H  is CTS/RTS
  677.     handshaking. Then on  sending files add your @<list  file>. always make
  678.     sure the  file name here  is the same  as the one  you specify for  the
  679.     Control file name. On receive you can put the directory to download the
  680.  
  681.     ───────────────────────────────────────────────────────────────────────
  682.     Bob Henderson (1:3812/10)                                       Page  9
  683.     ───────────────────────────────────────────────────────────────────────
  684.     ───────────────────────────────────────────────────────────────────────
  685.                          SuperBBS 1.15+ Protocol HELP
  686.     ───────────────────────────────────────────────────────────────────────
  687.  
  688.     files  into, but  since Sbbs  will change  to that  directory it is not
  689.     necessary. The Log file name should  be the same as the DSZLOG variable
  690.     since Lynx  uses that variable. DO  NOT use the switch  to make lynx go
  691.     full screen in  DV, this causes severe bleed  through. Normally it will
  692.     look kinda like DSZ, just a filename and what block it is on.
  693.  
  694.         I have been unable to test this  one with SHARE, so be careful with
  695.     it.  You may  not think  that  something  like file  shareing would  be
  696.     necessary, may  never see 2 people  download the same file  but it does
  697.     happen so it is a feature that you need when running a multinode BBS.
  698.  
  699.     M I C R O T E C H
  700.     ─────────────────
  701.  
  702.         What!  Microtech?  Well  I  used  to  say  the  same  thing, Who is
  703.     Microtech? Well they or him/she writes protocols for their BBS package.
  704.     Originally all of there protocols were designed around Osiris. But will
  705.     now  work with  any type   BBS, unregistered  versions will  only allow
  706.     single file transfers  so if you want batch you  have to pay. Microtech
  707.     has  several different  protocols. Zmodem,  Ymodem, Xmodem,  Tmodem and
  708.     Zmax. Most of them work very well, I have had some problems with Tmodem
  709.     and was unable to get support from there BBS, their main thing was that
  710.     I am not running  Osiris so no support, even if  I registered. Anyway I
  711.     have  all of  their latest  protocols available  on my  BBS. The latest
  712.     versions that I have are..
  713.  
  714.         Zmodem v9.00
  715.         Ymodem v7.00
  716.         Xmodem v2.00
  717.         Tmodem v8.00
  718.         Zmax   v1.00b
  719.  
  720.         I will not go into great detail  on each of these, only to say that
  721.     the command line  switches are pretty much the  same. Their Ymodem does
  722.     offer  a G  error correcting  mode, and  Tmodem is  very fast  (when it
  723.     works). I  will post Tmodem, and  then the different command  lines for
  724.     ONLY the ones  that are different. You MUST have  the COMx variable set
  725.     for a locked port. If COM1 is locked  at 38400 you have to have in your
  726.     autoexec.bat SET COM1=38400 . Don't ask  me why but Microtech uses this
  727.     setting to do some things, although  they say their protocol is smart I
  728.     can't figure  out why it needs  this then. There is  one catch to using
  729.     other Microtech  protocols other than  Tmodem, they don't  create a log
  730.     file. See Errorlevel protocols to see how to run these.
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.     ───────────────────────────────────────────────────────────────────────
  744.     Bob Henderson (1:3812/10)                                       Page 10
  745.     ───────────────────────────────────────────────────────────────────────
  746.     ───────────────────────────────────────────────────────────────────────
  747.                          SuperBBS 1.15+ Protocol HELP
  748.     ───────────────────────────────────────────────────────────────────────
  749.  
  750.         Here is an example of the config setup...
  751.     ───────────────────────────────────────────────────────────────────────
  752.     Activated           : Yes
  753.     Name                : Tmodem v8.00
  754.     Key                 : T
  755.     Batch               :  No
  756.     Protocol type       : OTHER
  757.     Log style           : OTHER
  758.     Download command    : c:\ext\tmodem.exe /B*B /P*P /Xi:\sbbs\dszlog.n2
  759.                           /S @i:\files.n2
  760.     Upload command      : c:\ext\tmodem.exe /B*B /P*P /Xi:\sbbs\dszlog.n2
  761.                           /Ue:\uploads /R
  762.     Log file name       : i:\sbbs\dszlog.n2
  763.     Control file name   : i:\files.n2
  764.     Effic               : 98
  765.     Download Ctl Str    : %1
  766.     Upload Ctl Str      : %1
  767.     Download log keyword: S
  768.     Upload log keyword  : R
  769.     File name word NR.  : 3
  770.     ───────────────────────────────────────────────────────────────────────
  771.  
  772.         NOTE: Log  style is not DSZ  compatible. This is where  you have to
  773.     enter some things  for the download and upload  keyword. Also what part
  774.     of the line is  the filename. I worked with this for  quite a while and
  775.     these settings do  work. Also Tmodem is very  tempermental. Most of the
  776.     time it works  fine but then sometimes it just  doesn't want to send or
  777.     receive files. Can't explain why but a cold reboot clears it up. If you
  778.     are running a fast modem without a  16550 chip you will have to use the
  779.     /A switch which is for  Xon/Xoff handshaking, otherwise Tmodem will not
  780.     be very reliable. As  the rest of the pass *B which  is a must for this
  781.     protocol and *P  port to it. /X is redefine  log file, which by default
  782.     is tmodem.log. the  only problem with this is the  log file will end up
  783.     in the download directory. So  /Xi:\sbbs\dszlog.n1 will always be where
  784.     Sbbs and I  can find it. If you decide  to use the /U<upload> directory
  785.     Tmodem DOES NOT want a \ at the end of the path. A Tmodem log file will
  786.     look like..
  787.  
  788.         S 261453 121% SBBS_104.ZIP
  789.         │   │     │       └ File name, third item
  790.         │   │     └ percent efficiency, second item
  791.         │   └ Size of file, first item
  792.         └ S for send, R for receive.  zero'th item?
  793.  
  794.         This is what Sbbs will find and this is where you need to tell Sbbs
  795.     to find  the Key word, S  or R, and the  filename, third column. Notice
  796.     also that I have Tmodem listed as a single file transfer but pass along
  797.     the control  file. Why you  ask, read the  section on Global  transfers
  798.     with single file protocols and it should clear this up.
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.     ───────────────────────────────────────────────────────────────────────
  806.     Bob Henderson (1:3812/10)                                       Page 11
  807.     ───────────────────────────────────────────────────────────────────────
  808.     ───────────────────────────────────────────────────────────────────────
  809.                          SuperBBS 1.15+ Protocol HELP
  810.     ───────────────────────────────────────────────────────────────────────
  811.  
  812.     S Z M O D E M
  813.     ─────────────
  814.  
  815.         SzModem is another Zmodem protocol with  a few twists. It works and
  816.     allows  your users  to do  useful things  while downloading,  like play
  817.     games, use  Sdos, view files,  and even page  the sysop (you)  and chat
  818.     while  downloading. Pretty  neat eh?  Szmodem does  come with  it's own
  819.     configuration utility but I never felt  safe in using it so the command
  820.     line is where I tell it what to  do. The main thing that I wanted it to
  821.     do was create a  DSZLOG file and not make all the  other log files that
  822.     Szmodem can do. I was successful  except for one thing. Szmodem insists
  823.     on  sending  a  file  with  information  to  the  other  Szmodem before
  824.     transfer, the  only problem with  this is it  records this file  in the
  825.     DSZLOG.  Then the  user gets  prompted for  description of SZ??????.???
  826.     when they probably don't even know what it is. Oh well, not perfect but
  827.     it does work.
  828.  
  829.         Here is an example of the config setup...
  830.     ───────────────────────────────────────────────────────────────────────
  831.     Activated           : Yes
  832.     Name                : SZmodem v1.60
  833.     Key                 : S
  834.     Batch               : Yes
  835.     Protocol type       : OTHER
  836.     Log style           : DSZ
  837.     Download command    : c:\ext\szmodem.exe PORT *P BAUD *B /LOCK 9600
  838.                           /NOLOG /DL /DT 0 /NOSBL /SZT SZ @i:\files.n2
  839.     Upload command      : c:\ext\szmodem.exe PORT *P BAUD *B /LOCK 9600
  840.                           /NOLOG /DL /DT 0 /NORBL /SZT RZ
  841.     Log file name       : i:\sbbs\dszlog.n2
  842.     Control file name   : i:\files.n2
  843.     Effic               : 98
  844.     Download Ctl Str    : %1
  845.     Upload Ctl Str      : %1
  846.     Download log keyword: S
  847.     Upload log keyword  : S
  848.     File name word NR.  : 1
  849.     ───────────────────────────────────────────────────────────────────────
  850.  
  851.         As  you can  see Szmodem's  command  line  is rather  long. All  is
  852.     explained in the Szmodem documents, you  should use as I have. This way
  853.     Szmodem won't create  a SZMODEM.LOG and some other  log files, also the
  854.     /DL tells Szmodem  to Log to the DSZLOG variable.  Szmodem IS NOT SHARE
  855.     aware. Maybe this will help make your mind up.
  856.  
  857.     H S / L I N K
  858.     ─────────────
  859.  
  860.         Hs/Link is the new kid on the block with great potential. It allows
  861.     bi-directional transfers and a easy setup for both you and the user. It
  862.     creates a DSZ compatible log file and uses the  DSZLOG  variable.   One
  863.     problem that  plagues it at the  moment is most all  protocol doors are
  864.     unable to  acknowledge that a file  was uploaded and downloaded  in the
  865.     same  session. I  sent some  info  to  Aki about  how Hs/Link  logs its
  866.  
  867.     ───────────────────────────────────────────────────────────────────────
  868.     Bob Henderson (1:3812/10)                                       Page 12
  869.     ───────────────────────────────────────────────────────────────────────
  870.     ───────────────────────────────────────────────────────────────────────
  871.                          SuperBBS 1.15+ Protocol HELP
  872.     ───────────────────────────────────────────────────────────────────────
  873.  
  874.     transfers  so maybe  the next  version of  Sbbs can  handle it.  At the
  875.     moment if a  user starts downloading files and  while downloading sends
  876.     you  a  file  Sbbs  will  log  the  downloads  and  any  uploads ALL as
  877.     downloads. Not very good for the  user. Run HSconfig and set the things
  878.     that apply to your modem, like CTS/RTS  .. Now for the info that I have
  879.     stored in HSCONFIG...
  880.  
  881.     HS/Link: Basic Settings
  882.     ───────────────────────────────────────────────────────────────────────
  883.     COM port number (1-8) . . . . . . . . . . . 1
  884.     Directory for downloaded files. . . . . . . E:\UPLOADS\________________
  885.     Use "SLOW HANDSHAKE" during disk I/O. . . . N
  886.  
  887.     HS/Link: Advanced COM Settings
  888.     ───────────────────────────────────────────────────────────────────────
  889.     Non-Standard COM base (in DECIMAL, 0 = standard COM port) . . . . 0░░
  890.     Non-Standard COM IRQ (1-7, 0 = standard COM port) . . . . . . . . 0_
  891.     COM port open speed (300-115200, 0 = automatic) . . . . . . . . . 0__
  892.     Effective modem-to-modem speed (0 = same as open speed) . . . . . 0__
  893.     Enable CTS hardware handshake . . . . . . . . . . . . . . . . . . Y
  894.     Enable RTS hardware handshake . . . . . . . . . . . . . . . . . . Y
  895.     Enable XON/XOFF software handshake. . . . . . . . . . . . . . . . Y
  896.     Enable Carrier Detect checking. . . . . . . . . . . . . . . . . . Y
  897.     Preserve original time/date stamp on received files . . . . . . . N
  898.  
  899.     HS/Link: Advanced Optional Features
  900.     ───────────────────────────────────────────────────────────────────────
  901.     Attempt to Resume aborted transfers . . . . . . . . . . . . . . . N
  902.     Keep partial files from aborted transfers . . . . . . . . . . . . N
  903.     Allow received files to overwrite/modify existing files . . . . . N
  904.     Enable file read/write buffering. . . . . . . . . . . . . . . . . Y
  905.     Enable "Dynamic-Code-Substitution" logic. . . . . . . . . . . . . Y
  906.     Size of transmitted data blocks (64-4096 bytes/block) . . . . . . 1024
  907.     Number of blocks in transit before ACK is required (1-1000) . . . 8___
  908.     Disable transmission of ACK for each block received . . . . . . . N
  909.     Force remote unit to use local option settings. . . . . . . . . . N
  910.  
  911.     HS/Link: Screen Settings
  912.     ───────────────────────────────────────────────────────────────────────
  913.     Enable Full-Screen status display . . . . . . . . . . . . . . . . Y
  914.     Enable direct video writing (turn off in DesqView/DoubleDOS/etc). N
  915.     Color of BORDER in full screen mode . . . . . . . . . . . . . . . 7__
  916.     Color of PROMPTS in full screen mode. . . . . . . . . . . . . . . 47_
  917.     Color of WINDOW TITLE in full screen mode . . . . . . . . . . . . 79_
  918.     Color of WINDOW CONTENTS in full screen mode. . . . . . . . . . . 31_
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.     ───────────────────────────────────────────────────────────────────────
  930.     Bob Henderson (1:3812/10)                                       Page 13
  931.     ───────────────────────────────────────────────────────────────────────
  932.     ───────────────────────────────────────────────────────────────────────
  933.                          SuperBBS 1.15+ Protocol HELP
  934.     ───────────────────────────────────────────────────────────────────────
  935.  
  936.         Here is an example of the config setup...
  937.     ───────────────────────────────────────────────────────────────────────
  938.     Activated           : Yes
  939.     Name                : HsLink 1.0
  940.     Key                 : H
  941.     Batch               : Yes
  942.     Protocol type       : OTHER
  943.     Log style           : DSZ
  944.     Download command    : c:\ext\hslink.exe -P*P -NV -E*B -Ue:\uploads\
  945.                           @i:\files.n2
  946.     Upload command      : c:\ext\hslink.exe -P*P -NV -E*B -Ue:\uploads\
  947.     Log file name       : i:\sbbs\dszlog.n2
  948.     Control file name   : i:\files.n2
  949.     Effic               : 98
  950.     Download Ctl Str    : %1
  951.     Upload Ctl Str      : %1
  952.     Download log keyword: H
  953.     Upload log keyword  : H
  954.     File name word NR.  : 1
  955.     ───────────────────────────────────────────────────────────────────────
  956.  
  957.         Basic stuff here, -P*P for port to use, -NV is for me and Desqview,
  958.     tells Hs/Link  to do bios screen  writes. Use -E*B to  have the correct
  959.     estimated  times  and  last  but  not  least  give  both the upload and
  960.     download commands  and -U<upload path> Since  Hs/Link is bi-directional
  961.     at least you should have some control over where the files are going to
  962.     end up. Once again, make sure the control file and the download command
  963.     file name @<file  name> are the same. Also the  log file name should be
  964.     the same as your DSZLOG variable.
  965.  
  966.  
  967.     S U P E R K
  968.     ───────────
  969.  
  970.         I'm a little confused, last time  I looked SuperK was up to version
  971.     4.53 or something like that. Next thing  I know I see this thing called
  972.     SuperK HST somewhere and download it, version number was 1.06 but after
  973.     looking at it  it was the new SuperK,  go figure! I had already  set up
  974.     all of the old SuperK prots then new comes along so more testing to do.
  975.     This new  version has 15  different ways of  getting files out  the old
  976.     comm  port.  Each  variation  has  something  different  but  the  main
  977.     objective  is  to  get  the  file  there  fast.  New  to  Superk  is  a
  978.     installation program, run it and set up what you need to. My settings.
  979.  
  980.     Flags/Misc
  981.     ┌────────────────────────────────────────┐
  982.     │ a) Port Speed                : 0       │
  983.     │ b) Modem Speed               : 0       │
  984.     │ c) Comm port is locked       : Yes     │
  985.     │ d) Check CTS/RTS lines       : Yes     │
  986.     │ e) Monitor carrier detect    : Yes     │
  987.     │ f) 16550 Fifos enabled       : Yes     │
  988.     │ g) Suspend during writes     : Yes     │
  989.     │ h) Drain buffer on writes    : No      │
  990.  
  991.     ───────────────────────────────────────────────────────────────────────
  992.     Bob Henderson (1:3812/10)                                       Page 14
  993.     ───────────────────────────────────────────────────────────────────────
  994.     ───────────────────────────────────────────────────────────────────────
  995.                          SuperBBS 1.15+ Protocol HELP
  996.     ───────────────────────────────────────────────────────────────────────
  997.  
  998.     │ i) Strip file name           : No      │
  999.     │ j) Save aborted downloads    : No      │
  1000.     │ k) Overwrite existing files  : No      │
  1001.     │ l) Silent Mode (no alarm)    : Yes     │
  1002.     │ m) Erase batch filename list : Yes     │
  1003.     │ n) Extended log entries      : No      │
  1004.     │ o) Direct Screen Writes      : Yes     │
  1005.     │ p) Xfer file on 0 byte files : Yes     │
  1006.     │ q) Default direction         : Send    │
  1007.     │ r) Receive resume mode       : Auto    │
  1008.     │ s) BBS node character        :         │
  1009.     └────────────────────────────────────────┘
  1010.  
  1011.     Paths/Logs
  1012.     ┌────────────────────────────────────────────┐
  1013.     │ a) Log : I:\SBBS\DSZLOG.N?                 │
  1014.     │ b) Xfer: I:\FILES.N?                       │
  1015.     │ c) WrkP:                                   │
  1016.     │ d) OvlP: C:\EXT\                           │
  1017.     │ e) Path:                                   │
  1018.     └────────────────────────────────────────────┘
  1019.  
  1020.     Please note that the  log file and control file name have  a ? in them.
  1021.     If  you run  multinode and  pass the  /N*N parameter  to Superk it will
  1022.     translate your  node number into the  name where the question  mark is.
  1023.     Only  thing to  watch out  for here  is it  only goes  1-9 then A-Z, no
  1024.     double digit numbers.
  1025.  
  1026.         Here is an example of the config setup...
  1027.     ───────────────────────────────────────────────────────────────────────
  1028.     Activated           : Yes
  1029.     Name                : Superk 8k-G
  1030.     Key                 : K
  1031.     Batch               : Yes
  1032.     Protocol type       : OTHER
  1033.     Log style           : DSZ
  1034.     Download command    : c:\ext\skhst.com P*P S9600 U*B N2
  1035.                           Li:\sbbs\dszlog.n2 SM-B F @i:\files.n2
  1036.     Upload command      : c:\ext\skhst.com P*P S9600 U*B N2
  1037.                           Li:\sbbs\dszlog.n2 RM-B F
  1038.     Log file name       : i:\sbbs\dszlog.n2
  1039.     Control file name   : i:\files.n2
  1040.     Effic               : 98
  1041.     Download Ctl Str    : %1
  1042.     Upload Ctl Str      : %1
  1043.     Download log keyword: S
  1044.     Upload log keyword  : S
  1045.     File name word NR.  : 1
  1046.     ───────────────────────────────────────────────────────────────────────
  1047.  
  1048.         Once you have run SKINST and set  it up it will write the info into
  1049.     the Superk  EXE file. Use  the P*P  to  set the port  to use, S<locked>
  1050.     should also be there if you run a locked port, the U*B is for Superk so
  1051.     it gives the correct estimated time for transfers. and don't forget N*N
  1052.  
  1053.     ───────────────────────────────────────────────────────────────────────
  1054.     Bob Henderson (1:3812/10)                                       Page 15
  1055.     ───────────────────────────────────────────────────────────────────────
  1056.     ───────────────────────────────────────────────────────────────────────
  1057.                          SuperBBS 1.15+ Protocol HELP
  1058.     ───────────────────────────────────────────────────────────────────────
  1059.  
  1060.     for the  node number in multiline  environments. This one setup  can be
  1061.     changed by  simply changing one letter  on the command line.  Here is a
  1062.     clip directly from Skinst's help section.
  1063.  
  1064.     RM-skyalcxnfdmer#
  1065.     ││││││└──── Save aborts toggle
  1066.     │││││└───── OverWrite toggle
  1067.     ││││└────── K9X calling toggle
  1068.     │││└─────── S)ingle file / B)atch mode flag
  1069.     ││└──────── Options delimiter
  1070.     │└───────── Protocol (X,C,W,Y,J,K,S,M,Q,E,D,B,F,H,I,N)
  1071.     │             X = XmodemChk C = XmodemCRC W = WXmodem   Y = 1K-Xmodem
  1072.     │             J = Jmodem 8K K = K9Xmodem  S = Super8K   M = Super8K-G
  1073.     │             Q = 1K Xmdm-G E = Three D   D = Three D-G B = 4 BY 4
  1074.     │             F = 4 BY 4-G  H = SixPack   I = SixPack-G N = None
  1075.     └────────── R)eceive / S)end flag  or  T)erminal mode
  1076.  
  1077.         Just by changing the letter before  the dash you can choose from 15
  1078.     different variations of Superk.
  1079.  
  1080.     B I M O D E M
  1081.     ─────────────
  1082.  
  1083.         BiModem is the only protocol that I know of that allows you to do a
  1084.     bi-directional  transfer,  chat,  and  add  files  to  the transfer all
  1085.     without leaving it's own screen. Pretty  wild huh? Oh well, many people
  1086.     will probably  jump down to this  part of the document  just to see how
  1087.     BiModem is set  up. First thing you need  to know is BiModem is  a very
  1088.     complicated protocol. Just because your users can't get it to work does
  1089.     not mean that yours is not working.  Both sides of the transfer must be
  1090.     set up correctly. Read the BiModem  documents, you will find that a lot
  1091.     of the  things are a little  different than your usual  protocol. After
  1092.     being thoroughly confused  by the BiModem documents come  back here and
  1093.     we will  go through the  basic (BASIC) setup  for BiModem. First  thing
  1094.     that you need to do is create a file, what kind of file? Just a regular
  1095.     text file,  in it will  be a list  of downloadable directories. If your
  1096.     using Frontdoor for your mailer this file looks just like the directory
  1097.     list for Freq's. Each line has one <drive>:<path> on it.
  1098.  
  1099.         E:\BBSUTIL
  1100.         E:\BBSPROG
  1101.         E:\PROGRAM
  1102.         E:\UPLOADS
  1103.         F:\SDS\SBBS
  1104.         F:\SDS\FRONT
  1105.         .... and so on
  1106.  
  1107.         You  can name  this list  anything you  want, using Frontdoors file
  1108.     that you  had already created  just saves some  time. BiModem will  use
  1109.     this  list to  find files  and to  determine rejections for duplicates.
  1110.     Next  step would  be to  run  BiMenu.  This is  BiModem's menu  system,
  1111.     although you can run each part  of BiModem separately running BiMenu is
  1112.     easier  (All you  have to  remember BiMenu).  Look at  each menu  item,
  1113.     change  what you  feel is  necessary, as  usual I  have a  clip from my
  1114.  
  1115.     ───────────────────────────────────────────────────────────────────────
  1116.     Bob Henderson (1:3812/10)                                       Page 16
  1117.     ───────────────────────────────────────────────────────────────────────
  1118.     ───────────────────────────────────────────────────────────────────────
  1119.                          SuperBBS 1.15+ Protocol HELP
  1120.     ───────────────────────────────────────────────────────────────────────
  1121.  
  1122.     BiMenu settings.  The label will  be the menu  choice and option  under
  1123.     that choice.
  1124.  
  1125.     Configure BiModem, General Options..
  1126.     ───────────────────────────────────────────────────────────────────────
  1127.  
  1128.     These options dictate what will be allowed when people
  1129.     request files from or send files to YOUR system
  1130.  
  1131.     Allow current directory access (Y/N)          Y
  1132.     Allow file names only (no paths) (Y/N)        Y
  1133.     Rename the file if it already exists (Y/N)    Y
  1134.     Always verify when done (Y/N)                 N
  1135.     Do NOT allow source deletion (Y/N)            Y
  1136.     Retain original file date (Y/N)               N
  1137.     Do NOT allow full directory transfers (Y/N)   Y
  1138.     Do NOT allow sub directory transfers (Y/N)    Y
  1139.     Replace Timer Interrupt (Y/N)                 N
  1140.     Replace Keyboard Interrupt (Y/N)              N
  1141.     Allow remote file requests (Y/N)              Y
  1142.     Allow local file requests (Y/N)               Y
  1143.     Skip transfer if same date/time/size (Y/N)    N
  1144.  
  1145.     Configure BiModem, Limits & Editing
  1146.     ───────────────────────────────────────────────────────────────────────
  1147.  
  1148.     These fields establish the limits of time/size and
  1149.     the editing characteristics.
  1150.  
  1151.     Number of seconds to wait for connect           40
  1152.  
  1153.     Operator Page allowed from  9: 0 till 22: 0 military time
  1154.  
  1155.     Phone number edit mask. All 9's will be replaced with a
  1156.     portion of the phone #. Other characters in the mask are
  1157.     placed in their display position as is. Please be sure
  1158.     to include 10 9's in the mask                 (999)999-9999
  1159.  
  1160.     Maximum # of bytes that can be sent during 1 connection
  1161.     0 means no limit                                     0
  1162.  
  1163.     Maximum time allowed during 1 connection  1 hours  0 minutes
  1164.  
  1165.     Max # of errors before disconnect (0=No Max)     0
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.     ───────────────────────────────────────────────────────────────────────
  1178.     Bob Henderson (1:3812/10)                                       Page 17
  1179.     ───────────────────────────────────────────────────────────────────────
  1180.     ───────────────────────────────────────────────────────────────────────
  1181.                          SuperBBS 1.15+ Protocol HELP
  1182.     ───────────────────────────────────────────────────────────────────────
  1183.  
  1184.     Configure BiModem, Download Options
  1185.     ───────────────────────────────────────────────────────────────────────
  1186.  
  1187.     These are the default settings that will be used when
  1188.     you request a file to be sent TO your computer
  1189.  
  1190.     If file exists, use verify to upload it (Y/N)      N
  1191.     If file exists, replace it (Y/N)                   N
  1192.     Verify files when done transferring (Y/N)          N
  1193.     Delete source file when done (Y/N)                 N
  1194.     Include matching files in sub directories (Y/N)    N
  1195.  
  1196.     Configure BiModem, Upload Options
  1197.     ───────────────────────────────────────────────────────────────────────
  1198.  
  1199.     These are the default settings that will be used when
  1200.     you request a file to be sent FROM your computer
  1201.  
  1202.     If file exists, use verify to upload it (Y/N)      N
  1203.     If file exists, replace it (Y/N)                   N
  1204.     Verify files when done transferring (Y/N)          N
  1205.     Delete source file when done (Y/N)                 N
  1206.     Include matching files in sub directories (Y/N)    N
  1207.  
  1208.     Configure BiModem, Filenames and Paths
  1209.     ───────────────────────────────────────────────────────────────────────
  1210.  
  1211.       Directory that files will be received into
  1212.     E:\UPLOADS\
  1213.       Directory that aborted files will be renamed into
  1214.     E:\WRK\
  1215.       Delete aborted destination files (Y/N)        Y
  1216.       List of directories that determine rejections
  1217.     C:\EXT\BIMODEM.DIR
  1218.       Directory or list of directories files are sent from
  1219.     C:\EXT\BIMODEM.DIR
  1220.       Path to Password file
  1221.  
  1222.       Path to UpLoad/Download list (Transfer List) file
  1223.     BIMODEM.PTH
  1224.       Path to default files list for BiList
  1225.     FILES.BBS
  1226.       Path to log file
  1227.     C:\EXT\BIMODEM.LOG
  1228.       Are connects/disconnects to be logged (Y/N)        N
  1229.       Are file transfer statistics to be logged (Y/N)    Y
  1230.  
  1231.         Pay close attention to the directory  list, this is the name of the
  1232.     file that you should have already  made. The log file and other options
  1233.     for filenames can be changed on  the command line. Most important is to
  1234.     assign a upload  directory, and a directory to  place aborted files. If
  1235.     the user  aborts a file and  tries another upload with  BiModem it will
  1236.     then check the abort directory for the files and try to resume. Now for
  1237.     a look at the Sbbs config.
  1238.  
  1239.     ───────────────────────────────────────────────────────────────────────
  1240.     Bob Henderson (1:3812/10)                                       Page 18
  1241.     ───────────────────────────────────────────────────────────────────────
  1242.     ───────────────────────────────────────────────────────────────────────
  1243.                          SuperBBS 1.15+ Protocol HELP
  1244.     ───────────────────────────────────────────────────────────────────────
  1245.  
  1246.         Here is an example of the config setup...
  1247.     ───────────────────────────────────────────────────────────────────────
  1248.     Activated           : Yes
  1249.     Name                : Bimodem v1.24
  1250.     Key                 : B
  1251.     Batch               : Yes
  1252.     Protocol type       : BIMODEM
  1253.     Log style           : ICOM
  1254.     Download command    : c:\ext\bimodem.com /LCOM*P /S%2 /T%3 /Ii:\bilog.n2
  1255.                           /Pi:\files.n2 /F
  1256.     Upload command      : c:\ext\bimodem.com /LCOM*P /S%2 /T%3 /Ii:\bilog.n2
  1257.                           /F
  1258.     Log file name       : i:\bilog.n2
  1259.     Control file name   : i:\files.n2
  1260.     Effic               : 98
  1261.     Download Ctl Str    : %1
  1262.     Upload Ctl Str      : %1
  1263.     Download log keyword: S
  1264.     Upload log keyword  : S
  1265.     File name word NR.  : 0
  1266.     ───────────────────────────────────────────────────────────────────────
  1267.  
  1268.         Look,  protocol  type  BIMODEM,  log  style  ICOM.  This is a must.
  1269.     BiModem  creates a  binary log file  that Sbbs  is able  to read. On the
  1270.     command line you will need the following..
  1271.  
  1272.         /LCOM*P .......... Port to use, *P = port in config.
  1273.         /S%2 ............. Users download limit, remember that BiModem is a
  1274.                            bidirectional protocol that  allows the users to
  1275.                            add   files  while   downloading  or  uploading.
  1276.                            Without  this the  user can  start a  upload and
  1277.                            download anything on your  BBS, no limit (except
  1278.                            for whats in BiModem setup).
  1279.         /T%3 ............. Time  left, need  this  one  also, for  the same
  1280.                            reasons as the download limit.
  1281.         /I<log file>...... This is  your bimodem.log. You can  use the same
  1282.                            name as  specified in the config  or a different
  1283.                            one. If  you are multiline this  will need to be
  1284.                            different for  each line. Make sure  the name is
  1285.                            the same as specified on the "Log file name".
  1286.         /P<filename>...... Used for downloads, this is created by Sbbs, use
  1287.                            the  name you  specified for  the "Control  File
  1288.                            Name".
  1289.         /F ............... I feel kinda lost  now, I'm writing this doc and
  1290.                            everything   is  coming   from  memory,   can't
  1291.                            remember what this switch is for but use it.
  1292.  
  1293.         That should cover  it on BiModem, if nothing  works check the setup
  1294.     in BiMenu again  and look over the config. If  still nothing works send
  1295.     me your BiModem.Cfg and Sproto.Bbs and  a short what happens and I will
  1296.     try to get  it ready for you to  pick up. BiModem is one  protocol that
  1297.     you should have available, only problem  is if it isn't correctly setup
  1298.     your users  can rape some files  off your board. BiModem  is popular on
  1299.     BBS's that have  file ratios, since you can upload  and download at the
  1300.     same time this saves the user and your BBS some time.
  1301.     ───────────────────────────────────────────────────────────────────────
  1302.     Bob Henderson (1:3812/10)                                       Page 19
  1303.     ───────────────────────────────────────────────────────────────────────
  1304.     ───────────────────────────────────────────────────────────────────────
  1305.                          SuperBBS 1.15+ Protocol HELP
  1306.     ───────────────────────────────────────────────────────────────────────
  1307.  
  1308.     G L O B A L   D O W N L O A D S
  1309.     ───────────────────────────────
  1310.  
  1311.         Many of  you use the global  download options that SuperBBS  has to
  1312.     offer. There is  one thing that as of this  writing the %1 parameter on
  1313.     the command  line only passes the  filename, no path to  the file. What
  1314.     happens when a user tries to download a file that is not in the current
  1315.     directory? The  protocol will only  get a filename  and will abort  the
  1316.     transfer. Most  protocols handle batch transfers  so this usually would
  1317.     not be a issue, but some don't so there has to be a way to handle it. I
  1318.     have worked out a simple effective solution to this problem through the
  1319.     use of a batch file and a  program called WHEREIS. The Whereis that I'm
  1320.     talking  about is  Keith Ledbetters  Whereis. Version  4.4b is the most
  1321.     current to  my knowledge. What  whereis can do  for you is  find a file
  1322.     then change to that directory, where you can then execute the protocol.
  1323.     This might not work  for your system or you might not  even want to use
  1324.     it. If you don't allow global  downloads then you shouldn't have to use
  1325.     this approach. Otherwise this is the way to do it for now.
  1326.  
  1327.         First you  have to find  WHEREIS, I have  a copy on  my BBS and  is
  1328.     available for Freq. A wonderful program it is, searching all drives for
  1329.     that  one file,  making dupe  file lists,  checking inside archives and
  1330.     many more options.  Then you need to make your  batch file. The command
  1331.     line for  whereis is real  simple "WHEREIS FILENAME",  this will search
  1332.     for FILENAME on the current drive. "WHEREIS FILENAME -gf" will find the
  1333.     file then change to that directory. Ok so you have more than one drive,
  1334.     no problem. Try "WHEREIS DEF:FILENAME -gf", this will look for FILENAME
  1335.     on drives  D,E, and F. In  your config you should  then call your batch
  1336.     file using *C /C  to execute it and pass all parameters  to it like you
  1337.     would the protocol.  For Example.. Say the command  line for DSZ Xmodem
  1338.     would be "C:\EXT\GSZ.EXE est 0 *B sx  %1". Make you batch file and call
  1339.     it something like  DSZXMOD.BAT, now for the command  line you would use
  1340.     "*C /C DSZXMOD.BAT *B %1". Then your batch file would look like ...
  1341.     ───────────────────────────────────────────────────────────────────────
  1342.     @echo off
  1343.  
  1344.     REM If file not there have whereis find file and change directories...
  1345.     if not exist %2 whereis def:%2 -gf
  1346.  
  1347.     REM Execute GSZ with estimate baud rate and filename...
  1348.     c:\ext\gsz.exe est 0 %1 sx %2
  1349.  
  1350.     REM Make sure we end up back on C drive and in Sbbs directory
  1351.     c:
  1352.     cd\sbbs
  1353.     ───────────────────────────────────────────────────────────────────────
  1354.  
  1355.         Using this batch method works real  well, on catch to using whereis
  1356.     to  change directories.  Say you  have  a  file MYFILE.ZIP  on D:  in a
  1357.     offline directory  to be moved  and the new  version is on  E:, whereis
  1358.     will change directories  to the first file it  finds. That's it.. Maybe
  1359.     this will explain  why DSZ and a few others  didn't work. Just fill out
  1360.     the config as  you would for a regular DSZ  and everything should work,
  1361.     that is for the ones that create  a DSZ compatible log file. Read on on
  1362.     how to do the ones with no log files.
  1363.     ───────────────────────────────────────────────────────────────────────
  1364.     Bob Henderson (1:3812/10)                                       Page 20
  1365.     ───────────────────────────────────────────────────────────────────────
  1366.     ───────────────────────────────────────────────────────────────────────
  1367.                          SuperBBS 1.15+ Protocol HELP
  1368.     ───────────────────────────────────────────────────────────────────────
  1369.  
  1370.     E R R O R L E V E L   P R O T O C O L S
  1371.     ───────────────────────────────────────
  1372.  
  1373.         As of version 1.15, SuperBBS does not support errorlevel protocols.
  1374.     Can't really  explain why but  maybe because there  are not to  many of
  1375.     them out there. So what happens  when you like Jmodem, or the Microtech
  1376.     protocols? You use a little batch file magic. No 4dos here just regular
  1377.     old  DOS. If  you haven't  done so  read over  the previous  section on
  1378.     Global downloads before going any further.
  1379.  
  1380.         Back so soon? Ok, let's get on  with it. As you should already know
  1381.     you can  create files using  redirection with DOS.  Using commands like
  1382.     ECHO and  REM will create  files if redirected,  > out to  file or < in
  1383.     from  file. A  command like  "ECHO Hello  > TEST.IT"  will make  a file
  1384.     called  TEST.IT in  the current  directory and  in it  will be the word
  1385.     "Hello" (without quotes).  Ok so how does this  help you? Well SuperBBS
  1386.     needs  a protocol  that will  make a  log file,  an errorlevel protocol
  1387.     exits at a certain errorlevel when a transfer is done. You can use this
  1388.     errorlevel and depending on it use ECHO to make you log file. Does this
  1389.     make any sense at all? For the  command line it would be similar to the
  1390.     Global download, I will use Jmodem as an example.
  1391.  
  1392.         Here is an example of the config setup...
  1393.     ───────────────────────────────────────────────────────────────────────
  1394.     Activated           : Yes
  1395.     Name                : Jmodem
  1396.     Key                 : J
  1397.     Batch               : Yes
  1398.     Protocol type       : OTHER
  1399.     Log style           : OTHER
  1400.     Download command    : *C /C JMOD S *P *N %1
  1401.     Upload command      : *C /C JMOD R *P *N %1
  1402.     Log file name       : i:\sbbs\dszlog.n1
  1403.     Control file name   : i:\files.n1
  1404.     Effic               : 98
  1405.     Download Ctl Str    : %1
  1406.     Upload Ctl Str      : %1
  1407.     Download log keyword: S
  1408.     Upload log keyword  : R
  1409.     File name word NR.  : 1
  1410.     ───────────────────────────────────────────────────────────────────────
  1411.  
  1412.         What? The same  batch for send and receive! Yep,  I hate having 200
  1413.     batch files laying around. I have just one DOORS batch, about 5k but it
  1414.     runs all  of my door  games for  BOTH  nodes. The command  line will be
  1415.     expanded out to  "<path\name command.com> /C JMOD S  1 1 2400 FILENAME"
  1416.     depending on what port you are using.  Jmodem does not need a baud rate
  1417.     so  no need  to have  it on  the command  line. Notice  the upload  and
  1418.     download keyword, also the Filename  word number. These things are real
  1419.     important to  Sbbs, this also plays  importance in the batch  file. You
  1420.     will see  what I mean. The  following batch is also  made up for global
  1421.     downloads using WHEREIS.
  1422.  
  1423.  
  1424.  
  1425.     ───────────────────────────────────────────────────────────────────────
  1426.     Bob Henderson (1:3812/10)                                       Page 21
  1427.     ───────────────────────────────────────────────────────────────────────
  1428.     ───────────────────────────────────────────────────────────────────────
  1429.                          SuperBBS 1.15+ Protocol HELP
  1430.     ───────────────────────────────────────────────────────────────────────
  1431.  
  1432.     @echo off
  1433.  
  1434.     REM Check if %1 is null
  1435.     if %1.==. goto ERROR
  1436.  
  1437.     REM %1 is fine goto %1, should be R or S
  1438.     goto %1
  1439.  
  1440.     :S
  1441.         REM Is file there? find if not there.
  1442.         if not exist %4 whereis def:%4 -gf
  1443.  
  1444.     :R
  1445.         REM Execute Jmodem, should be jmodem R1 filename.ext
  1446.         c:\ext\jmodem.exe %1%2 %4
  1447.  
  1448.         REM check errorlevel, if bad xfer goto BAD
  1449.         if errorlevel 1 goto BAD
  1450.  
  1451.         REM Good transfer, create logfile using DSZLOG environment
  1452.         echo %1 %4 > %DSZLOG%
  1453.  
  1454.         REM goto OK
  1455.         goto OK
  1456.  
  1457.     :ERROR
  1458.         echo Hey Sysop, what ya tryin to do!
  1459.         goto OK
  1460.  
  1461.     :BAD
  1462.         REM Bad transfer, E means error, make log with filename
  1463.         echo E %4 > %DSZLOG%
  1464.  
  1465.     :OK
  1466.         REM goto back to C: and change to nodes dir, *N on command line
  1467.         c:
  1468.         cd\sbbs\n%3
  1469.     ───────────────────────────────────────────────────────────────────────
  1470.  
  1471.         Not to bad eh? Take out all the REM's and this batch file is pretty
  1472.     small. Ok for a quick explanation.  Lets just imagine the user wants to
  1473.     download ALLFILES.ZIP and  it is in the current  directory. The user is
  1474.     on Node  2 which uses COM1.  When SuperBBS expands the  command line it
  1475.     will  look  like  "C:\COMMAND.COM  JMOD  S  1  2 ALLFILES.ZIP" and then
  1476.     execute this command.  The batch file takes over  with these parameters
  1477.     and will first  check if %1 (S) is  null, if not it will  goto label S.
  1478.     Since you  read the part on  Global downloads (did you?)  the next line
  1479.     should explain itself, check for the file.  If it's not the find it and
  1480.     change directories. Since the file  is in the current directory whereis
  1481.     will not even  be run. Then it passes on  to executing Jmodem. With the
  1482.     parameters supplied it will do "c:\ext\jmodem.exe S1 ALLFILES.ZIP". The
  1483.     user gets the  file successfully, Jmodem will exit at errorlevel 0 then
  1484.     so  "if  errorlevel  1"  is  incorrect  so  control  goes  to  the next
  1485.     statement. "ECHO  S ALLFILES.ZIP > I:\SBBS\DSZLOG.N2"  is what the next
  1486.  
  1487.     ───────────────────────────────────────────────────────────────────────
  1488.     Bob Henderson (1:3812/10)                                       Page 22
  1489.     ───────────────────────────────────────────────────────────────────────
  1490.     ───────────────────────────────────────────────────────────────────────
  1491.                          SuperBBS 1.15+ Protocol HELP
  1492.     ───────────────────────────────────────────────────────────────────────
  1493.  
  1494.     line would look like on my system  after DOS expands it. The S is there
  1495.     to say  the file was sent,  then the filename. Sbbs  will read this log
  1496.     file and look for the S, found it so look for filename, ok transfer ok,
  1497.     delete log,  update and all  is done. If  the transfer was  BAD, jmodem
  1498.     would exit at  errorlevel 1 and the log file  would then have E instead
  1499.     of S in the logfile. Sbbs will  understand this and say "0 files sent".
  1500.         That's  it  for  errorlevel  protocols,  give  them  all a try. The
  1501.     microtech protocols are very nice and have to be run this way.
  1502.  
  1503.     O T H E R   P R O T O C O L S
  1504.     ─────────────────────────────
  1505.  
  1506.         There are  many protocols out there  that I used to  use, but since
  1507.     getting my  USR I found that  these do not support  the high baud rates
  1508.     and locked ports. Some of the ones that I have used and tested are.
  1509.  
  1510.     QMXFER, All variations. Mainly Imodem
  1511.     PUNTER, a relaxed Xmodem style. Good for sending to Commodores
  1512.     rCMODEM, very nice. Does high speed but not locked ports
  1513.     TRANSLINK, can't explain this one, it worked at 2400
  1514.     WXMODEM, Windowed Xmodem. A little faster
  1515.     PCKERMIT, Yuk! 2400 max speed
  1516.  
  1517.     and many others that have since disappeared from my hard drive.
  1518.  
  1519.     M O D E M   S E T T I N G S
  1520.     ───────────────────────────
  1521.  
  1522.         Just though that you might like to look at my modem settings. These
  1523.     settings may not  work for you but they are  very reliable on my system
  1524.     and as far as  I know no one has trouble connecting  with either one of
  1525.     my nodes.
  1526.  
  1527.     USR HST/DS Settings...
  1528.     ───────────────────────────────────────────────────────────────────────
  1529.     ATI4
  1530.     USRobotics Courier 14400 HST Dual Standard Settings...
  1531.  
  1532.        B0  C1  E0  F1  M0  Q0  V1  X4
  1533.        BAUD=38400  PARITY=N  WORDLEN=8
  1534.        DIAL=HUNT   ON HOOK   TIMER
  1535.  
  1536.        &A3  &B1  &C1  &D2  &G0  &H1  &I0  &K3  &L0
  1537.        &M4  &N0  &P0  &R2  &S1  &T5  &X0  &Y0  %R0
  1538.  
  1539.        S00=000  S01=000  S02=043  S03=013  S04=010
  1540.        S05=008  S06=002  S07=060  S08=002  S09=006
  1541.        S10=015  S11=055  S12=050  S13=000  S14=001
  1542.        S15=008  S16=000  S17=000  S18=000  S19=000
  1543.        S20=000  S21=010  S22=017  S23=019  S24=150
  1544.        S25=000  S26=001  S27=000  S28=008  S29=020
  1545.        S30=000  S31=000  S32=002  S33=000  S34=000
  1546.        S35=000  S36=000  S37=000  S38=002
  1547.  
  1548.  
  1549.     ───────────────────────────────────────────────────────────────────────
  1550.     Bob Henderson (1:3812/10)                                       Page 23
  1551.     ───────────────────────────────────────────────────────────────────────
  1552.     ───────────────────────────────────────────────────────────────────────
  1553.                          SuperBBS 1.15+ Protocol HELP
  1554.     ───────────────────────────────────────────────────────────────────────
  1555.  
  1556.     ATI5
  1557.  
  1558.     USRobotics Courier 14400 HST Dual Standard NRAM Settings...
  1559.  
  1560.        DIAL=TONE   B0  F1  M0  X4
  1561.        BAUD=38400  PARITY=N  WORDLEN=8
  1562.  
  1563.        &A3  &B1  &G0  &H1  &I0  &K3  &L0  &M4  &N0
  1564.        &P0  &R2  &S1  &T5  &X0  &Y0  %R0
  1565.  
  1566.        S02=043  S03=013  S04=010  S05=008  S06=002
  1567.        S07=060  S08=002  S09=006  S10=015  S11=055
  1568.        S12=050  S13=000  S15=008  S19=000  S21=010
  1569.        S22=017  S23=019  S24=150  S26=001  S27=000
  1570.        S28=008  S29=020  S32=002  S33=000  S34=000
  1571.        S35=000  S36=000  S37=000  S38=002
  1572.  
  1573.        STORED PHONE #0:
  1574.                     #1:
  1575.                     #2:
  1576.                     #3:
  1577.  
  1578.     Nothing special on using the USR modem, just set everything to what you
  1579.     see above, then for a init string  use ATZ|. The USR is very stable and
  1580.     in my opinion the best modem around.  Take a look at S38, this may help
  1581.     you with those users that don't get to see your goodbye screen.
  1582.  
  1583.     ZOOM 2400 v.42bis
  1584.     ───────────────────────────────────────────────────────────────────────
  1585.  
  1586.     ACTIVE PROFILE:
  1587.     B1 E0 L2 M0 N1 P Q0 V1 W0 X4 Y0 &C1 &D2 &G0 &J0 &K3 &Q5 &R0 &S0 &T4 &X0
  1588.     &Y0  S00:000 S01:000  S02:043 S03:013  S04:010 S05:008  S06:002 S07:055
  1589.     S08:002 S09:006 S10:014 S11:055 S12:050 S18:000 S25:005 S26:001 S36:007
  1590.     S37:006 S38:002 S44:003 S46:138 S48:007 S49:016 S50:255
  1591.  
  1592.     STORED PROFILE 0: B1 E0  L2 M0 N1 P Q0 V1 W0 X4 Y0  &C1 &D2 &G0 &J0 &K3
  1593.     &Q5  &R0 &S0  &T4 &X0  S00:000 S02:043  S06:002 S07:055 S08:002 S09:006
  1594.     S10:014 S11:055 S12:050 S18:000 S25:005 S26:001 S36:007 S37:006 S38:002
  1595.     S44:003 S46:138 S48:007 S49:016 S50:255
  1596.  
  1597.     STORED PROFILE 1: B1 E0  L2 M0 N1 P Q0 V0 W0 X4 Y0  &C1 &D2 &G0 &J0 &K3
  1598.     &Q5  &R0 &S0  &T4 &X0  S00:000 S02:043  S06:002 S07:030 S08:002 S09:006
  1599.     S10:014 S11:055 S12:050 S18:000 S25:005 S26:001 S36:005 S37:000 S38:002
  1600.     S44:003 S46:138 S48:007 S49:008 S50:255
  1601.  
  1602.     TELEPHONE NUMBERS:
  1603.     0=                                      1=
  1604.     2=                                      3=
  1605.  
  1606.         Zoom makes  a good modem, but  after being spoiled by  the USR it's
  1607.     not very much fun  to set up. The main thing that  does not show in the
  1608.     AT&V is the S95 register, default is set to 44, you NEED to set this to
  1609.     3, S95=3 . This will make the Zoom return the true connect speed and if
  1610.  
  1611.     ───────────────────────────────────────────────────────────────────────
  1612.     Bob Henderson (1:3812/10)                                       Page 24
  1613.     ───────────────────────────────────────────────────────────────────────
  1614.     ───────────────────────────────────────────────────────────────────────
  1615.                          SuperBBS 1.15+ Protocol HELP
  1616.     ───────────────────────────────────────────────────────────────────────
  1617.  
  1618.     a error free connect will append /ARQ to the end. With it set at 44 all
  1619.     connects will be 9600 regardless of what the real time speed is.
  1620.  
  1621.         I have  the USR locked at  38400 and the Zoom  at 9600, I generally
  1622.     use X00 but switch every now and then to BNU, just to test a program or
  1623.     something but I always  come back to X00. One thing to  note is X00 may
  1624.     not work on some internal modems, both  of mine are external. I used to
  1625.     have 2 internal  modems and X00 would not work  on either one of these.
  1626.     This is because  of X00's complete handling of  the port interrupts. If
  1627.     you can get it to work Great!. My command lines for either are.
  1628.  
  1629.     X00.SYS 2 E NOPOST DV B,0,38400 B,1,9600 R=1024 T=1024 F=15
  1630.  
  1631.     BNU.COM /P:2 /L0:38400 /L1:9600 /Z0 /M- /F /R:1024 /T:1024
  1632.  
  1633.     I load either from the config.sys, I know BNU is a com file but you can
  1634.     use "INSTALL"  a DOS command to  load tsr's from your  config.sys. This
  1635.     will save you the environment space for that program. Both fossils work
  1636.     well loaded high with QEMM's loadhi.
  1637.  
  1638.     W H O   I S   B O B ?
  1639.     ─────────────────────
  1640.  
  1641.         Better yet where  is Bob? Bob lives in a  little town in Texas, how
  1642.     about Richwood Texas. I guess that is why my BBS is called the Richwood
  1643.     BBS? Could be a good reason. I originally purchased my home computer to
  1644.     do some  programming at home, mostly  for work but also  to learn a few
  1645.     new things. Since the  computer had a modem in it I  had to call around
  1646.     and see just what a BBS  was. Hmmmmm, very interesting. Didn't know you
  1647.     could do that on a phone  line. Download files, chat... WOW! Since that
  1648.     time  (10/90) I  had started  my own  BBS, joined  Fidonet, got another
  1649.     line (2 BBS  lines), increased my phone bill %400,  and generally had a
  1650.     good time.  Back to 10/90,  I was looking  around for a  BBS to try, so
  1651.     many choices. What do I do?  I tried, setup, ran just about everything.
  1652.     Then just before the BBS went online  I found a new one, SuperBBS 1.04.
  1653.     Ok so it was a little unstable  back then, but it had everything that I
  1654.     wanted  at that  time. Ease  of setup,  lots of  third party  utilities
  1655.     because it  was Qbbs/Ra compatible, and  it had more things  in it than
  1656.     the other compatibles (Qbbs/Ra) had. So  since then I have been running
  1657.     SuperBBS.  Now comes  the fun  part.. Qbbs/Ra/Sbbs  compatible today is
  1658.     hard to  say. Other than  the message base  there is nothing  left. All
  1659.     three  did something new to  the users.bbs,  same size  but those empty
  1660.     holes in  it are filled  up differently between  the three. Since  I do
  1661.     some programming at  work why don't I write some  new things for Super.
  1662.     Easier  than it  sounds, I  don't  do  Pascal very  well. My  choice of
  1663.     compilers is C.  So after spending many hours  writing conversion utils
  1664.     for me to use and converting  the Pascal structures for all three BBS's
  1665.     I'm  ready. Watch  out for  some  good  utils coming  your way.  I have
  1666.     already  released MKFOLDER.ZIP,  conversion utility  for CONFIG.BBS  to
  1667.     FOLDER.FD and sent it out in SDS.
  1668.         On  the personal  side ..  I  work  for BASF  (yeah those  diskette
  1669.     things)  as a  production technician,   and do  most of  the analytical
  1670.     programming for  our unit. I enjoy  helping YOU, and I  don't even know
  1671.     who you  are. No matter. We all live  on the same  planet, or do  we? I
  1672.     can't think of anything else to say so let's move on.
  1673.     ───────────────────────────────────────────────────────────────────────
  1674.     Bob Henderson (1:3812/10)                                       Page 25
  1675.     ───────────────────────────────────────────────────────────────────────
  1676.     ───────────────────────────────────────────────────────────────────────
  1677.                          SuperBBS 1.15+ Protocol HELP
  1678.     ───────────────────────────────────────────────────────────────────────
  1679.  
  1680.     C R E D I T S
  1681.     ─────────────
  1682.  
  1683.         Many  thanks  go  out  to  Aki  and  Risto,  Thanks for writing and
  1684.     maintaining a wonderful  BBS package. I'm sure great  things are on the
  1685.     road ahead for the SuperBBS Group.
  1686.  
  1687.         I also  wish to thank Charles  Buchanan, without his drive  to test
  1688.     protocols  there would  not be  much of  a document  here. I could have
  1689.     called myself  in DV but trying  to watch both windows  in 50 line mode
  1690.     hurts my eyes.
  1691.  
  1692.         Special thanks to my wife Becky for actually putting up with me for
  1693.     the past few  years and letting me stay  up to the wee hours  doing the
  1694.     BBS thing.
  1695.  
  1696.         That should  cover it, if  I left someone  out SORRY. Mucho  thanks
  1697.     anyways.
  1698.  
  1699.     N O W   W H A T ?
  1700.     ─────────────────
  1701.  
  1702.         Ok so I forgot  one thing, If you have any problems  at ALL you can
  1703.     reach me in the Fidonet SUPERBBS echo or send netmail to 1:3812/10.
  1704.  
  1705.         I don't think that I should  require a disclaimer for this file but
  1706.     here goes.  Use any information  provided within this  document at your
  1707.     own risk.  Bob's not responsible for  typo errors or bad  grammar. Just
  1708.     remember, It's only a hobby, only a hobby, a hobby, hobby....hobby
  1709.  
  1710.         This document  was written using  Sageword 4.0 word  processor, and
  1711.     spelling  checked with  Share Spell.  Without either  it would  be alot
  1712.     messier.
  1713.  
  1714.         Have Fun!
  1715.         Bob
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.     ───────────────────────────────────────────────────────────────────────
  1736.                                  T H E   E N D
  1737.     ───────────────────────────────────────────────────────────────────────
  1738.